home *** CD-ROM | disk | FTP | other *** search
/ The Atari Compendium / The Atari Compendium (Toad Computers) (1994).iso / files / prgtools / mint / devices / lpdev.zoo / lpdev.asc < prev    next >
Encoding:
Text File  |  1993-08-23  |  2.7 KB  |  131 lines
  1.  
  2.  
  3. LPDEV(8)                   MiNT Programmer's Manual                   LPDEV(8)
  4.  
  5.  
  6. NAME
  7.      lpdev - installs the /dev/lp device
  8.  
  9.  
  10. SYNOPSIS
  11.      lpdev
  12.  
  13.  
  14. DESCRIPTION
  15.      lpdev will  install  /dev/lp  ,  a  buffered  Centronics  device  driver.
  16.      Typically, this command will be put in your mint.cnf file.
  17.  
  18.      This device is write-only; you won't be able to read anything from it (it
  19.      will behave like /dev/null ). It's also very dumb: the bytes written into
  20.      /dev/lp will be sent without modification to  the  Centronics  port.   In
  21.      fact,  the  only service offered by /dev/lp is buffering: it should allow
  22.      you to print  without  hogging  the  cpu.   To  take  full  advantage  of
  23.      buffering,  you  should write large blocks of data into /dev/lp , not one
  24.      byte at a time, in order to reduce system call overhead.
  25.  
  26.      The default size of the buffer is 24 kbyte; jobs that print files  bigger
  27.      than that should be put in the background.
  28.  
  29.      The ioctl modes recognized by this device are:
  30.  
  31.      FIONREAD, FIONWRITE
  32.           return the number of bytes that can  be  read  from  (always  0)  or
  33.           written to the device.
  34.  
  35.      TIOCFLUSH
  36.           clears the buffer.
  37.  
  38.      F_GETLK, F_SETLK, F_SETLKW
  39.           handle file locking on the device.  You  can  only  lock  the  whole
  40.           device, and only with a write-lock; read-locks are ignored.
  41.  
  42.  
  43. SEE ALSO
  44.      lpflush(1)
  45.  
  46.  
  47. DIAGNOSTICS
  48.      Error messages are reported on standard output, and lpdev exits with  the
  49.      appropriate return-code (usually EACCDN or ENSMEM).
  50.  
  51.      lpdev: MiNT is not running
  52.           self-explanatory
  53.  
  54.      lpdev: device "u:\dev\lp" already installed
  55.           self-explanatory
  56.  
  57.      lpdev: Centronics interrupt already in use
  58.           The MFP interrupt source #0 is already active, probably  because  of
  59.           another spooler.
  60.  
  61.  
  62.  
  63.  
  64.                                  July, 1993                                  1
  65.  
  66.  
  67.  
  68. LPDEV(8)                   MiNT Programmer's Manual                   LPDEV(8)
  69.  
  70.  
  71.      lpdev: not enough memory
  72.           There's no memory left for the circular buffer.
  73.  
  74.      lpdev: unable to install device
  75.           MiNT couldn't install the  device  for  another  reason  that  those
  76.           mentioned above.
  77.  
  78.  
  79. AUTHOR
  80.      Thierry Bousch (bousch@suntopo.matups.fr)
  81.  
  82.  
  83. BUGS
  84.      The /dev/lp device can't be opened in exclusive mode; you must  open  it,
  85.      then apply a lock on the file descriptor.
  86.  
  87.      The file locking functions haven't been tested, so they won't work.
  88.  
  89.  
  90.  
  91.  
  92.  
  93.  
  94.  
  95.  
  96.  
  97.  
  98.  
  99.  
  100.  
  101.  
  102.  
  103.  
  104.  
  105.  
  106.  
  107.  
  108.  
  109.  
  110.  
  111.  
  112.  
  113.  
  114.  
  115.  
  116.  
  117.  
  118.  
  119.  
  120.  
  121.  
  122.  
  123.  
  124.  
  125.  
  126.  
  127.  
  128.  
  129.                                  July, 1993                                  2
  130.  
  131.